home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 20
/
Cream of the Crop 20 (Terry Blount) (1996).iso
/
editor
/
textvw16.zip
/
TEXTVIEW.DOC
< prev
next >
Wrap
Text File
|
1996-05-31
|
30KB
|
899 lines
$VER: TextView.doc 1.6 (31.5.96)
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
May 31, 1996
Torbj÷rn Andersson
presents
TextView 1.6
Shareware
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
1. Contents
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Contents ................................................. 1
Introduction ............................................. 2
Requirements ............................................. 3
Usage .................................................... 4
Load ..................................................... 5
Save ..................................................... 6
Crunch ................................................... 7
Keys ..................................................... 8
Mouse .................................................... 9
Search .................................................. 10
Goto .................................................... 11
Iconify ................................................. 12
Settings ................................................ 13
Comments ................................................ 14
Bugs .................................................... 15
History ................................................. 16
Credits ................................................. 17
Distribution ............................................ 18
Shareware ............................................... 19
Author .................................................. 20
2. Introduction
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
TextView is one of the programs I use most. I made it
because I wanted a good and fast textviewer. And TextView is
fast. It loads files in a twinkling of an eye, it has custom
routines for text output and scrolling, and searching for a
string is very fast. I have tried to make it configurable
and userfriendly, so I hope it can be used by anybody.
Features:
╖ Written entirely in assembler.
╖ Has custom routines for text output and scrolling.
╖ Scrollbar with soft realtime scrolling.
╖ Can show different fontstyles and colors.
╖ Doesn't show commands in AmigaGuide files.
╖ Files can be shown in binary and hexadecimal form.
╖áPipe support.
╖ Xpk support.
╖ Reads files crunched with PowerPacker.
╖ Can crunch and save files.
╖ Multiple files.
╖ Font sensitive.
╖ Random palette.
╖ Window on own screen or any public screen.
╖ Configure font, screen depth, placement of scrollbar, etc.
╖ Very fast searchroutine.
╖ Bookmarks.
╖ Iconify.
╖ Can be made Resident.
╖ AmigaOS 1.2/1.3 compatible, AmigaOS 2.0/3.0 aware.
3. Requirements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A few features require AmigaOS 2.0 or higher, otherwise
AmigaOS 1.2 is enough.
Reqtools.library is required if you want to:
Choose file (loading and saving), choose font, choose screen
mode, search for a string, set tab size, set priority, change
palette.
Alternatively asl.library can be used for the file-, font-
and screen mode selecting.
Powerpacker.library is required if you want to:
View a file that is both crunched and encrypted with
PowerPacker, or crunch and save a file.
Xpk libraries are required if you want to view a file
compressed with Xpk.
Asl.library is a part of AmigaOS 2.0+.
Reqtools.library and powerpacker.library are popular
libraries by Nico Franτois. You should not have any big
trouble finding these if you don't already have them.
4. Usage
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
TextView can be started from both CLI and Workbench, and can
be made resident. It doesn't take any arguments from
Workbench, except the file if you use TextView as default
tool. From CLI the usage is:
TextView [file|dir] [TABS <n>] [BIN|HEX|ASCII] [ICON]
Explanation of options:
TABS <n>
Use tabsize n.
BIN|HEX|ASCII
View file in bin/hex mode, or force normal viewing. If none
of these options is given, hex mode will automatically be
used if the file is executable, an icon, an iff file or has
(many) exceptional characters.
ICON
Start iconified.
(KS 2.0+)
5. Load
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you start TextView with no arguments, it will open a file
requester. You can specify a filename on the commandline to
load directly, or a directory to position the file requester
in.
If you want to load a new file, use "Open..." in the Project
menu, or "Open New..." if you want to keep the first file.
The first free buffer will be used when selecting Open New,
and if none is free the screen will flash.
TextView will load the whole file in one turn. It has some
disadvantages. It requires that there is a free continuous
block of memory as large as the file. The loading cannot be
interrupted. You can't start reading until the whole file
is loaded. But it is fast.
If the file was crunched with PowerPacker or Xpk, it will
automatically be decrunched before it is shown. If it is
encrypted you will be asked for a password first. A
progress bar will be used when loading and decompressing
xpk-files.
When the file is loaded, TextView will count the number of
lines in it, and at the same time create a small speed up
table used when scrolling through the file.
If a file is loaded from a pipe device, TextView will first
pull the whole file from it in small blocks. Then it will
allocate a block of memory as large as the whole file and
copy the smaller parts to it. Thus the memory required for
this is twice the size of the file, and it will lead to
memory fragmentation. But I hope it is better than no pipe
support at all.
6. Save
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sometimes I load a huge file of a floppy disk with TextView,
and then discover that I want a copy of it on the HD. Since
the file is in memory, it would be a waste of time to have
to access the slow floppy disk once again. I think it is
natural to have a save function in a textviewer, even if it
is not possible to edit the text.
Use Save As in the Project menu to save the current file.
TextView will warn you if the file already exists.
7. Crunch
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Save PP in the Project menu can be used to crunch a file
using the powerpacker.library and then save it.
You can't use this function to encrypt or crunch executable
files, it only handles "data" files. The efficiency used is
always "best". Speedup buffer is automatically adjusted to
available memory. One or two "*" will be shown in the
titlebar while crunching if the largest buffer couldn't be
allocated; and crunching is then slower. You can abort
crunching at any time by selecting Save PP again.
8. Keys
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use About in the Project menu, or "?", to see the key
commands.
The Help key will show some system info and information
about all files loaded. A "*" marks which one of the buffers
that is currently shown.
Keys 1,2,... switches between file buffers.
Use shift and an F-key to set a bookmark the same F-key to
go to that bookmark.
Use B/H keys to toggle between bin/hex/normal view mode.
TextView will quit if you press Esc, Q, Ctrl-C or Ctrl-D.
Ctrl-D will set a returncode of 20, which can be used to
break scripts.
You can use the arrow keys to view lines that are too long,
or use Word Wrap by pressing W. TextView will then format
the text by putting line feeds where appropriate. Word Wrap
cannot be undone.
Shift-E will start and pass the filename to the editor set
in ENV:EDITOR.
9. Mouse
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can use the mouse to move through the file.
When the select (left) button is pressed, TextView will
start to examine the mouse position. When it is moved a
little bit away from the middle of the window, the text will
start scrolling up or down. The further the mouse is moved
from the middle, the faster the text will scroll.
You do not have to keep the button pressed, clicking is
enough for TextView to